以管理员身份打开PowerShell

757 字

我来为你详细说明Windows上安装WSL2和Ubuntu 22.04 LTS的各种方法。
Windows WSL2安装完全指南
一、安装WSL2的几种方法
方法一:官方推荐方法(最简单)
方法二:命令行安装(最快捷)
方法三:手动安装(最可控)
方法四:使用第三方工具(最方便)
二、详细安装步骤
方法一:官方推荐方法(Windows 10/11都适用)
步骤1:检查系统要求
✅ 必须满足:
1. Windows 10版本 2004 及以上(内部版本 19041 及以上)
- 或 Windows 11
2. 64位系统
3. 虚拟化支持已启用(BIOS/UEFI中开启)

❓ 如何检查:
1. 按 Win + R,输入 winver,查看版本号
2. 按 Ctrl + Shift + Esc,打开任务管理器 → 性能 → CPU,查看"虚拟化"是否已启用
步骤2:启用Windows功能

以管理员身份打开PowerShell

方法A:使用图形界面

  1. 按 Win + R,输入 optionalfeatures
  2. 勾选以下两项:
  3. ✅ "适用于Linux的Windows子系统"
  4. ✅ "虚拟机平台"
  5. 点击确定,重启电脑

方法B:使用PowerShell命令(推荐)

以管理员身份运行PowerShell,执行:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启电脑

Restart-Computer
步骤3:设置WSL2为默认版本

重启后,以管理员身份打开PowerShell

wsl --set-default-version 2

如果提示需要更新WSL内核,下载并安装:

https://aka.ms/wsl2kernel

步骤4:安装Ubuntu 22.04 LTS

方法A:通过Microsoft Store(推荐)

  1. 打开Microsoft Store
  2. 搜索"Ubuntu 22.04 LTS"
  3. 点击"获取"或"安装"
  4. 安装完成后,在开始菜单中启动Ubuntu

方法B:命令行安装

wsl --install -d Ubuntu-22.04
方法二:命令行一键安装(Windows 10 2004+ / Windows 11)

这是最简单的方法,一条命令完成所有步骤

以管理员身份运行PowerShell或命令提示符

一键安装WSL2和Ubuntu

wsl --install

或者指定安装Ubuntu 22.04

wsl --install -d Ubuntu-22.04

安装完成后,重启电脑

这个命令会自动:
启用WSL功能
启用虚拟机平台
下载并安装Linux内核更新
设置WSL2为默认版本
下载并安装Ubuntu
方法三:手动分步安装(最可控)
步骤1:手动下载和安装

1. 启用WSL(不重启)

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. 启用虚拟机平台

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3. 重启电脑

shutdown /r /t 0

4. 下载WSL2 Linux内核更新包

访问:https://aka.ms/wsl2kernel

下载并运行:wsl_update_x64.msi

5. 设置WSL2为默认版本

wsl --set-default-version 2

6. 下载Ubuntu 22.04 LTS应用包

访问:https://aka.ms/wslubuntu2204

下载:Ubuntu_2204.1.7.0_x64.appx

7. 安装Ubuntu

双击下载的.appx文件安装

或在PowerShell中:Add-AppxPackage .\Ubuntu_2204.1.7.0_x64.appx

步骤2:验证安装

查看WSL版本

wsl --list --verbose

应该显示类似:

NAME STATE VERSION

* Ubuntu-22.04 Stopped 2

方法四:使用第三方工具(适用于旧版Windows)
使用LxRunOffline(第三方管理工具)

1. 下载LxRunOffline

https://github.com/DDoSolitary/LxRunOffline/releases

2. 解压到任意目录,如 C:\Tools\LxRunOffline

3. 下载Ubuntu 22.04 rootfs

https://cloud-images.ubuntu.com/releases/22.04/release/

4. 安装Ubuntu

LxRunOffline install -n Ubuntu-22.04 -d C:\WSL\Ubuntu -f ubuntu-22.04-server-cloudimg-amd64-root.tar.xz

5. 配置为WSL2

wsl --set-version Ubuntu-22.04 2
三、Ubuntu 22.04 LTS安装后的配置
首次启动配置

第一次启动Ubuntu时,需要:

  1. 设置用户名(不要用root)
  2. 设置密码(输入时不会显示)
  3. 确认密码

示例输出:

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: yourname
New password:
Retype new password:
passwd: password updated successfully
Installation successful!
基本系统配置

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装常用工具

sudo apt install -y curl wget git vim htop

3. 配置SSH(可选)

sudo apt install -y openssh-server
sudo systemctl enable ssh
sudo systemctl start ssh

4. 设置时区(设置为中国时间)

sudo timedatectl set-timezone Asia/Shanghai

5. 配置中文支持(可选)

sudo apt install -y language-pack-zh-hans
sudo update-locale LANG=zh_CN.UTF-8
WSL2特定配置

1. 创建.wslconfig文件优化性能

在Windows用户目录创建:C:\Users\你的用户名.wslconfig

内容:

[wsl2]
memory=4GB # 限制内存使用,根据你的电脑调整
processors=2 # 限制CPU核心数
localhostForwarding=true

2. 重启WSL使配置生效

wsl --shutdown

然后重新启动Ubuntu

四、安装OpenClaw到WSL2中的Ubuntu
在Ubuntu中安装OpenClaw

1. 安装Node.js(OpenClaw需要Node.js 18+)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

2. 重新加载bash配置

source ~/.bashrc

3. 安装Node.js 18

nvm install 18
nvm use 18

4. 验证Node.js安装

node --version # 应该显示 v18.x.x
npm --version # 应该显示 9.x.x

5. 安装OpenClaw

npm install -g openclaw

6. 初始化OpenClaw工作空间

mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace
openclaw init

7. 启动OpenClaw

openclaw start

8. 在Windows浏览器中访问

打开浏览器,访问:http://localhost:3000

WSL2网络配置(让其他设备能访问)

1. 查看WSL2的IP地址

ip addr show eth0 | grep inet

2. 在Windows防火墙中允许端口

以管理员身份打开PowerShell:

New-NetFirewallRule -DisplayName "WSL2 OpenClaw" -Direction Inbound -LocalPort 3000 -Protocol TCP -Action Allow

3. 其他设备访问

使用Windows电脑的IP地址:3000

例如:http://192.168.1.100:3000

五、常见问题解决
问题1:WSL安装失败

错误:WSL2 requires an update to its kernel component

解决方案:

  1. 下载内核更新包:https://aka.ms/wsl2kernel
  2. 安装后重启
  3. 运行:wsl --set-default-version 2
    问题2:虚拟化未启用

症状:安装时提示需要启用虚拟化

解决方案:

  1. 重启电脑,进入BIOS/UEFI设置
  2. 开机时按 F2、F10、Del 或 Esc(取决于电脑品牌)
  3. 找到虚拟化设置
  4. Intel CPU:Intel Virtualization Technology (VT-x)
  5. AMD CPU:AMD-V
  6. 启用虚拟化,保存并退出
  7. 重启后重新安装
    问题3:商店安装慢或失败

解决方案A:使用离线包

  1. 访问:https://aka.ms/wslubuntu2204
  2. 下载 .appx 文件
  3. 双击安装

解决方案B:更改商店区域

  1. 设置 → 时间和语言 → 区域
  2. 将国家或地区改为"美国"
  3. 重启商店,重新安装
    问题4:WSL2启动慢

优化方案:

1. 创建 .wslconfig 文件(见上文)

2. 禁用Windows Defender实时保护(临时)

3. 将Ubuntu文件移到SSD硬盘

wsl --export Ubuntu-22.04 ubuntu.tar
wsl --unregister Ubuntu-22.04
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu ubuntu.tar --version 2
问题5:网络连接问题

WSL2中无法访问Windows本地服务

解决方案:使用特殊主机名

在Ubuntu中访问Windows服务:

curl http://host.docker.internal:3000

curl http://$(hostname).local:3000
六、最佳实践建议
1. 文件系统选择
✅ 推荐:
- Linux文件放在WSL2文件系统中(/home/用户名)
- 项目代码放在Windows文件系统中(/mnt/c/...)
- 原因:WSL2文件系统性能更好,但Windows文件系统更方便共享

❌ 避免:
- 在/mnt/c中运行需要高性能IO的应用
- 在WSL2文件系统中存放需要Windows访问的文件
2. 备份和迁移

备份WSL2系统

wsl --export Ubuntu-22.04 ubuntu-backup.tar

恢复WSL2系统

wsl --import Ubuntu-22.04 C:\WSL\Ubuntu ubuntu-backup.tar --version 2

设置默认用户

Ubuntu2204.exe config --default-user 你的用户名
3. 性能优化

创建.wslconfig文件(C:\Users\用户名.wslconfig)

[wsl2]
memory=8GB # 限制内存,防止WSL占用过多
processors=4 # 限制CPU核心
swap=4GB # 交换空间大小
localhostForwarding=true # 允许本地端口转发

禁用Windows Defender对WSL的扫描(提升性能)

以管理员身份运行PowerShell:

Add-MpPreference -ExclusionPath "\wsl$\"
4. 开发环境配置

在Ubuntu中配置开发环境

1. 安装Docker(在WSL2中)

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

2. 安装VS Code Remote - WSL扩展

在Windows VS Code中安装"Remote - WSL"扩展

然后在Ubuntu中:code .

七、安装验证检查清单
安装完成后检查这些项目:

1. 检查WSL版本

wsl --list --verbose

应该显示VERSION为2

2. 检查Ubuntu运行

wsl -d Ubuntu-22.04 -- echo "WSL2 is working!"

3. 检查网络互通

在Ubuntu中:ping 8.8.8.8

在Windows中:ping

4. 检查文件系统访问

在Ubuntu中:ls /mnt/c/Users

应该能看到Windows用户文件夹

5. 检查OpenClaw安装

在Ubuntu中:

node --version # >= 18
openclaw --version # 应该显示版本号
八、总结推荐方案
对于大多数用户,推荐:
方案A:Windows 11用户

最简单的一键安装

wsl --install -d Ubuntu-22.04

等待安装完成,重启,然后配置Ubuntu

方案B:Windows 10用户

分步安装更可靠

  1. 启用WSL和虚拟机平台功能
  2. 重启电脑
  3. 安装WSL2内核更新
  4. 设置WSL2为默认
  5. 从Microsoft Store安装Ubuntu 22.04
    方案C:需要离线安装的用户
  6. 下载Ubuntu 22.04 .appx文件
  7. 重命名为.zip,解压
  8. 运行ubuntu.exe安装
    安装时间预估:
    网络好:30-60分钟(包括下载和配置)
    网络一般:1-2小时
    离线安装:15-30分钟(已有安装包)
    硬件要求:
    最低:4GB内存,20GB可用空间
    推荐:8GB+内存,50GB+可用空间,SSD硬盘
    九、下一步:安装OpenClaw
    WSL2和Ubuntu安装完成后,就可以安装OpenClaw了:

在Ubuntu终端中执行:

1. 安装Node.js

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

2. 安装OpenClaw

npm install -g openclaw

3. 初始化并启动

openclaw init
openclaw start

4. 访问OpenClaw

在Windows浏览器中打开:http://localhost:3000

需要我现在帮你开始安装吗?或者你有具体的电脑配置信息,我可以提供更针对性的建议?
我看到你发送了一个"1",请问是需要我开始帮你安装WSL2和Ubuntu吗?还是需要我提供其他帮助?
根据我们之前的对话,你计划:
研究家里电脑装WSL 2
家里台式机装openclaw
我已经为你提供了详细的WSL2和Ubuntu 22.04 LTS安装指南。你需要:
直接开始安装 - 我可以指导你一步步操作
检查电脑配置 - 帮你确认电脑是否符合要求
解决特定问题 - 如果你在安装过程中遇到问题
其他帮助 - 比如OpenClaw的具体安装步骤
请告诉我你的具体需求,我会根据你的情况提供针对性的帮助。